# 🏠 Welcome

Thank you for purchasing our app. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here :

info.nemosofts@gmail.com
https://t.me/nemosofts

If you need help support related with app configuration or documentation, please write your support request via email with the format :

  • Email subject : Codecanyon username - Item purchase code
  • Email body : Describe your problem as clearly as possible.

You can see our other item here : https://codecanyon.net/user/nemosofts/portfolio


# Android Studio

Getting Started

Download and Install Java This section very important for you if this is first time develop android, if you already develop android project you can SKIP this page.

Download and Install Java

You can download JDK from this url :https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html

Download and Install Android Studio

You can download latest Android Studio from this url : https://developer.android.com/studio


# Firebase

Before you do step change the package name, you must do this step for firebase project configuration

Please note : this step is mandatory to generate google-services.json file

Visit Firebase Console

Please register or log in first and then select create new project. In the dialog window enter the name of the project that will be created and the contents of the state and then click the create project to continue.

After successfully creating a project on Firebase then the page will be redirected to the dashboard project that has been made.

Then on the dashboard Firebase select Add Firebase to your Android app. In the next dialog window enter the name of the Android application package and SHA1 of fingerprints Certificate (optional).

Next will download the configuration file json google-services.json automatically, which will be added in the directory app in the Android project.

Copy the google-services.json file that you have downloaded and put it in the Android Studio project.


# Push Notification

ONESIGNAL

Required For Setup

Keys & IDs Setup

  • Login to your OneSignal Account and select your app
  • Select SETTINGS > Keys & IDs to get your OneSignal APP ID and REST API KEY
  • Login to your Admin Panel, navigate to Settings menu to Notification Tab and put your OneSignal APP ID and OneSignal REST API KEY.

# Application ID

applicationId (Required)

applicationId is the main domain of your application. The applicationId is not related to the package name, although some application developers name the applicationId and the package name the same.

Each application to be published must have a unique domain name, generally using 3 word arrangements (can be more than 3), for example: com.app.yourappname, com is identified as the domain, app as the name of the developer and yourappname as the name of the application.

  1. Open Gradle Scripts > build.gradle (Module: app)
  2. Change the application ID with your own id name
  3. Click Sync Now.
  4. Change the id as unique as possible, because application id is very important used if you want to publish the application to the google play

Invalidate caches

After the renaming of the package name is complete, you need to rebuild the project and invalidate the cache

  1. Select Build > Rebuild Project and wait until the building project finishe
  2. Select File > Invalidate Caches.. > Invalidate and Restart

# Verify Purchase Code

https://verify.envatonemosofts.com

# Change Logo

The first step before changing the logo, it is highly recommended to delete the mipmap folder first

Then, after you delete the mipmap folder, the next steps are as follows:

  • Open Android Studio → File → New → Image Asset
  • You can choose 2 types of your icon type, that is Launcher Icon (Adaptive and Legacy) or (Legacy Only)
  • Recommended to use Launcher Icon (Adaptive and Legacy)
  • Browse and choose your image file icon (.png) format with square dimension and start customize your icon
  • Make sure the resource name is "ic_launcher" → Next
  • Make sure the selected Source Directory is "Main" → Finish

# Change Color

  1. to change the app color, you can see on the res/values/colors.xml
  2. Enter your color code inside each of strings tag :

# Change Text

The text asset consists of the application name of another text component inside the app, to change it

  1. You can see on the res/values/strings.xml
  2. Change value name in each strings tag according your needs.

# Release Version

Before release your application, make sure you have change the app versionCode and versionName in the build.gradle (Module: app). If you just release as new application, just set versionCode 1 and versionName 1.0.0 for first release. If you want to update your application, update your app version code and version to higher from previous version.


# Generate Signed Bundle / APK

If you have finished reskin the application and want to publish your application on Play Store, to sign your app in release mode in Android Studio, follow these steps :

On the menu bar, click Build → Generate Signed Bundle / APK → APK

On the Generate Signed Bundle or APK Wizard window, click Create new... to create your new keystore or If you already have a keystore, select Choose existing...

In the New Key Store window, provide the required information, on the Certificate form you must at least fill in First and Last Name, although other fields are optional, it is better if you fill in all fields, your key must be valid for at least 25 years, so you can Sign application updates with the same key for the life of your application.

On the Generate Signed Bundle or APK Wizard window, select a keystore, a private key, and enter the passwords for both. Then click Next

On the next window, select a destination for the signed Bundle.

Click Finish and the signed bundle will generated


# Data Safety Form

Recently, many applications received warnings about data security/data security. Data security will be enforced in April 2022, so all detected apps/games related to data collection need to be updated. Referring to the data security article, We try to describe the population according to code by looking at the following points:

Automatic filling out forms (Import CSV file)

Import a CSV file for faster autofill based on the tutorial:

Download Data Safety

Fill your privacy policy link

Finally, prepare your privacy policy link. You can use the app's privacy policy generator to create your privacy policy.

Until the stage of filling out the privacy policy has been completed, but for some source code there may be additional filling in accordance with the permissions used.


# Advertising ID

In addition to filling the Data Safety form, the new Play Store policy is to answer questions or fill in data related to Advertising ID, this app is using ads for monetization purposes, so when you want to publish your app on Google Play, it will detect the use of Advertising ID, this is a common thing because some of the libraries like google play services ads sdk and other related libraries used do integrate it for the needs of displaying ads, also Advertising ID declaration needed for sending push notification and analytics features.


# Troubleshooting

Cannot resolve symbol 'AGP'

The project is using an incompatible version (AGP X.X.X) of the Android Gradle plugin. Latest supported version is AGP X.X.X

You need to update your android studio. this issue will fixed.

Cannot resolve symbol 'BuildConfig'

It's not a real error, it's just a false positive, it occurs when the project is opened for the first time or the project is not yet in Build, this problem will be automatically resolved after the project is built.

Cannot resolve symbol 'R'

This issues happens after you've Refactor > Rename your package folder with a new name, actually it's also not an error, we could say this is one of the bugs in Android Studio which until now have not been or are not fixed, as in the previous case, it's not a real error, it's just a false positive and will automatically resolved after you Invalidate Caches in your Android Studio project, you can do this by selecting File > Invalidate Caches... > Invalidate and Restart


# Rating and Support

If you like our app, we will highly appreciate if you can provide us a rating of 5. You can rate us from your CodeCanyon Menu →Download page.

Once again, thank you so much for purchasing this app. As I said at the beginning, I'd be glad to help you if you have any questions relating to this app. No guarantees, but I'll do my best to assist. If you have a more general question relating to the apps on CodeCanyon, please feel free to email via our user page contact form or email support on below :

https://t.me/nemosofts

# FAQ

1. Why a complete reinstallation project is required for each update for Android Studio project?

Once you've reskin the project especially after package name / applicationId has been changed, the project structure will be changed, just replacing the updated files without having knowledge in Android Programming in advance will cause the project error dan failed to build the project, because of that, every we release the new update, you need to do reskin the application from begin, please note, update version is optional, update your application if you only find the issue from previous version or want to use all features from new version.